home *** CD-ROM | disk | FTP | other *** search
/ Aminet 45 / Aminet 45 (2001)(GTI - Schatztruhe)[!][Oct 2001].iso / Aminet / game / role / ldmud-3.2-bin.lha / mud / doc / efun / caller_stack < prev    next >
Text File  |  2001-04-06  |  935b  |  28 lines
  1. SYNOPSIS
  2.         object *caller_stack()
  3.         object *caller_stack(int add_interactive)
  4.  
  5. DESCRIPTION
  6.         Returns an array of the previous_object()s who caused the
  7.         call_other() to this_object().
  8.         previous_object(i) equals caller_stack()[i].
  9.         
  10.         If you pass the optional argument <add_interactive> (as true value)
  11.         this_interactive() is appended to the array, or 0 if there is no
  12.         current interactive.
  13.  
  14. EXAMPLE
  15.         interactive object A enters a command which causes
  16.         a call to a function in object B, that one calls a
  17.         function in object C and that, in turn, in object D
  18.  
  19.         If D now calls caller_stack() the result would be: ({C,B}).
  20.         If it calls caller_stack(1) the result is: ({C,B,A}).
  21.  
  22. HISTORY
  23.         Introduced in LDMud 3.2.6, suggested by TubMud.
  24.  
  25. SEE ALSO
  26.         caller_stack_depth(E), previous_object(E), this_interactive(E),
  27.         call_other(E)
  28.